home *** CD-ROM | disk | FTP | other *** search
/ Ham Radio 2000 / Ham Radio 2000.iso / ham2000 / packet / tf24c27 / tf_g.doc < prev    next >
Text File  |  1993-05-06  |  31KB  |  941 lines
  1. From DB2OS  to TNC2   @WW      
  2. TS: BF - Date/time: 0218/1121 - BID: 182308DB0FAU
  3. Title       : TheFirmware TF24c Update Information
  4. Path: !LX0PAC!DB0GE!DK0MTV!DB0GV!DB0SIF!DB0EAM!DB0FAU!
  5. de DB2OS @ DB0FAU
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.  
  15.  
  16.                        NORD><LINK's THE FIRMWARE
  17.  
  18.  
  19.  
  20.                             AX.25 Version 2
  21.  
  22.                        Multi Channel TNC Firmware
  23.  
  24.                               Version 2.4c
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32. 1.  Introduction
  33.  
  34.            The Firmware Version 2.4c DAMA/SMACK (xx Channel)
  35.                    Copyright by NORD><LINK, xx-xx-xx
  36.                      Free for non-commercial usage
  37.                          Checksum (xxxx) = xxxx
  38.  
  39. This is the message that the new version of The Firmware should  display
  40. in Terminal Mode when booting.
  41.  
  42. The Firmware can be installed in any TNC-2 (or compatible TNC).
  43.  
  44. This document is all about the latest official version of  The  Firmware
  45. from  NORD><LINK.  The  software no longer mentions all the contributing
  46. authors when booting since there are many that have worked  together  on
  47. developing the software over the years.
  48.  
  49. The original author of  The  Firmware  was  Michael  (DC4OX).  The  DAMA
  50. implementation was developed by Frank, DL8ZAW. Various improvements have
  51. been contributed by DF2AU, DB2OS,  DK6PX,  DL9HCJ,  DL1MEN,  DF7ZE,  and
  52. others (See Below).
  53.  
  54. This version (2.4c) is hopefully free of bugs. However,  it  has  always
  55. been  the intention to continually improve the software and to fix known
  56. problems as soon as possible.
  57.  
  58.  
  59. 2.  What Does "The Firmware" Support ?
  60.  
  61. This firmware supports fully the AX.25 Link Layer Protocol, Version 2 as
  62. specified  in  October 1984 by the ARRL. The old version of the protocol
  63. (1.x) is virtually extinct and as such, The Firmware no longer  supports
  64. it.
  65.  
  66. The software  can  support  multiple,  simultaneous  QSO's,  each  on  a
  67. separate  logical  channel  (or stream, as it is sometimes called).  The
  68. number of channels supported by each EPROM is determined at  compilation
  69. time.  The  usual  configuration has 10 channels available, but versions
  70. with upto a maximum of 27 channels can be built  for  use  by  mailboxes
  71. etc.
  72.  
  73. This version also supports user-access of TheNetNode nodes  running  the
  74. DAMA  protocol.  DAMA is an extension of the AX.25 protocol and provides
  75. users with many advantages and improvements over normal AX.25.
  76.  
  77. The Firmware will automatically determine whether to use DAMA or  normal
  78. AX.25  when  connecting to a station. Frames received from a DAMA Master
  79. are always displayed with "[DAMA]" appearing after  the  received  text.
  80. The  TNC will then only transmit when instructed to do so by the Master.
  81. Channels connected to non-DAMA equipped stations will be unaffected  and
  82. transmit in the normal manner.
  83.  
  84. If the TNC does not receive a "Poll" frame from the  "Master"  within  a
  85. user definable interval, it will switch out of DAMA mode.
  86.  
  87. When the TNC is operating as a DAMA Slave  (that  is,  a  user)  and  it
  88. receives a frame to be digipeated, it does so immediately.
  89.  
  90. The DAMA Protocol is described in  CQDL,  the  magazine  of  the  German
  91. national  society,  in the April 1989 issue. It is also described in the
  92. paper, "DAMA - A new method of handling packets  ?"  by  Detlef  Schmidt
  93. (DK4EG)   in  the  Proceedings  of  the  8th  ARRL  Computer  Networking
  94. Conference, October 1989 (ISBN 0-87259-251-0).
  95.  
  96.  
  97. 2.1.  KISS and SMACK
  98.  
  99. The new KISS compatible protocol "SMACK", developed by DL5UE and  DK5SG,
  100. is  also  supported  by  this  release  of The Firmware. See the release
  101. documentation for details about SMACK.
  102.  
  103. The user defined Hostmode parameters are remembered when  either  normal
  104. or  SMACK  KISS  modes  are  in  use. They are also retained following a
  105. reset. Switching out of KISS/SMACK mode back to Terminal  mode  restores
  106. the values stored previously.
  107.  
  108. The SMACK/KISS $FF frame carries the usual meaning and is used to switch
  109. out of that mode and back into normal The Firmware "Terminal" mode.
  110.  
  111. It should be noted that the internal software clock does not continue to
  112. keep real time whilst either KISS or SMACK is in use.
  113.  
  114.  
  115. 2.2.  Startup and the EPROM Checksum
  116.  
  117. Following each reset, the EPROM  checksum  is  recalculated.  This  must
  118. agree  with  the  checksum  shown  in  the round brackets of the startup
  119. message. If the two do not agree, then it is likely that the  EPROM  has
  120. been programmed incorrectly or that the code programmed was corrupted in
  121. some way.
  122.  
  123. After first installing the EPROM, it is useful to  perform  a  warmstart
  124. using  the  "<ESC>  QRES" command since some TNCs have problems with old
  125. code held in the battery-backed RAM. This will also load  the  RAM  with
  126. the default set of parameters from EPROM.
  127.  
  128. After the QRES command, the TNC callsign is empty and can be  set  using
  129. the  "<ESC> I" command. Other parameters can be set in a similar manner.
  130. The user defined values are stored in the battery-backed RAM.
  131.  
  132.  
  133. 3.  Basic Operation in Terminal Mode
  134.  
  135. All commands and information are sent to the TNC as lines of text.  Each
  136. line  can  be  upto  a maximum of 256 characters in length including the
  137. delimiting Carriage Return (<CR>). If the  256th  character  is  not  an
  138. <CR>, it is ignored and a "Bell" (<BEL>) is sent to the Terminal.
  139.  
  140. Single characters can be erased using either Backspace (<BS> =  Hex  08)
  141. or Delete (<DEL> = Hex 7F).
  142.  
  143. Control-U and Control-X will delete a whole line.
  144.  
  145. Control-R will move the cursor to the first  character  of  the  current
  146. line.  A  second  Control-R moves the cursor back to the end of the line
  147. ready for more input. Between these two  Control-R's,  all  other  input
  148. except for <XON> and <XOFF>, is ignored.
  149.  
  150. Bell (<BEL>) characters are sent direct to the terminal.
  151.  
  152. Lines beginning with the Escape (<ESC>) character cause a  asterisk  "*"
  153. to be displayed thus denoting that this is the start of a command line.
  154.  
  155. Commands sent without parameters will display the current value of  that
  156. parameter.
  157.  
  158. Lines beginning without <ESC> are taken as  being  Information  and  are
  159. sent out on air.
  160.  
  161.  
  162. 4.  General Terminal Mode Information
  163.  
  164. The Logical Channels
  165.  
  166. The Firmware in its standard form provides 11 logical  TNC  channels  to
  167. the  user.  The  terminal  is always logically connected to one of these
  168. channels which is selected by the "<ESC> S" command.
  169.  
  170. Channel 0 is reserved for sending only UNPROTO information eg  CQs,  IDs
  171. and  BEACONs.  The path to be used for this channel is, like the others,
  172. set using the "<ESC> C" command.
  173.  
  174. The other 1-10 channels can also send in UNPROTO mode, as long  as  they
  175. are  not  connected  to another station. Connect requests can be mode on
  176. any free channel. Incoming connect  requests  from  other  stations  are
  177. given  the  next  free  channel  in  sequence providing that the maximum
  178. number of simultaneous connects (set using the "<ESC>  Y"  command)  has
  179. not been exceeded.
  180.  
  181.  
  182. 4.1.  Selecting Channels
  183.  
  184. Information arriving on a channel that is  not  currently  selected,  is
  185. stored  in RAM until that channel is chosen for display using the "<ESC>
  186. S" command.
  187.  
  188. The "<ESC> L" command, without parameters, can be used to ascertain  the
  189. connect  status  of each channel and whether there is data waiting to be
  190. read. If any one of the unselected channels has data waiting to be read,
  191. this is also shown by the STA LED of the TNC lighting up.
  192.  
  193. Even if a station disconnects, data  is  kept  in  RAM.  This  makes  it
  194. possible  to store messages when the TNC is unattended. In short, a very
  195. simple mailbox!
  196.  
  197.  
  198. 4.2.  Changing the Connect Path
  199.  
  200. There is no need to disconnect a station before trying over a  different
  201. path.  Just  use  the  "<ESC>  C"  command to enter the new path for the
  202. desired channel and a reconnect attempt will automatically be made using
  203. the path entered. No data is lost during this process.
  204.  
  205. It is not possible to connect to the  same  callsign  on  two  different
  206. channels. This is a restriction of the AX.25 protocol.
  207.  
  208.  
  209. 4.3.  The AX.25 Protocol
  210.  
  211. The Firmware always uses  version  2  of  the  AX.25  protocol.  Connect
  212. requests  made  using  version  1  of  the  protocol will be immediately
  213. disconnected. Version 2 is better on busy networks.
  214.  
  215. The Firmware also "polls" in version 2 of AX.25. As soon as there is  no
  216. more  information  to  send,  a timer is started. If this timer runs for
  217. more than 3 minutes, a poll frame is sent to the other TNC thus ensuring
  218. that the link is still in use.
  219.  
  220. The number of "retries" attempted for any frame is set by the "<ESC>  N"
  221. command.
  222.  
  223.  
  224. 4.4.  Commands for Individual Channels
  225.  
  226. The commands, <ESC> F, I, N, O, and V can be set independently  on  each
  227. selected  channel.  Channel  0  holds the default value of each of those
  228. parameters.
  229.  
  230. A channel is selected, any of the parameters above  set  for  just  that
  231. channel and a connect is made. The QSO then proceeds using those values.
  232. As soon as the QSO ends, the values are  reset  to  those  held  in  the
  233. Channel 0 defaults.
  234.  
  235.  
  236. 5.  The Firmware's Monitor Functions
  237.  
  238. The "<ESC> M" command is used to activate the channel  traffic  monitor.
  239. The  parameters given to this command determine the types of frames that
  240. are seen in the monitor output. More than one parameter can be given  in
  241. the same command line.
  242.  
  243.      Parameter     Packet-Type
  244.      ---------     -----------
  245.          N         Monitor OFF
  246.          I         Show Information Frames
  247.          U         Show UNPROTO Frames
  248.          S         Show Supervisory (control) Frames
  249.          C         Monitor whilst connected on selected channel
  250.          +         Only Packets from/to given Stations (max 8)
  251.          -         Show no packets from/to given Stations (max 8)
  252.  
  253.  
  254. For example;
  255.  
  256.  
  257.      <ESC> M N         -    Switch the monitor off
  258.      <ESC> M IUS       -    Show Info, Unproto and Supervisory packets
  259.      <ESC> M + G6DHU   -    Show only packets to/from G6DHU
  260.      <ESC> M - G6DHU   -    Don't show G6DHU's packets
  261.  
  262.  
  263. The "+" and "-" parameters may not be used in the same command line  and
  264. they  must appear as the last parameter before the callsign. A parameter
  265. of just "+"  or  "-"  will  erase  the  current  list  of  calls  to  be
  266. monitored/ignored.
  267.  
  268. 5.1.  Monitor Output Format
  269.  
  270. The station digipeating a packet is shown with an asterisk "*".
  271.  
  272. AX.25 Frame types as they appear in monitor output are as follows;
  273.  
  274.  
  275.      Name           Meaning
  276.      ----           -------
  277.      RRa            Ready to Receive (frame acknowledge)
  278.      RNRa           Receiver Not Ready (temporarily busy)
  279.      REJa           Reject or duplicate packet
  280.      UI             UNPROTO information (broadcast)
  281.      DM             Busy
  282.      SABM           Connect Request
  283.      DISC           Disconnect Request
  284.      UA             Acknowledge Unnumbered frame
  285.      FRMR           Frame Reject (Protocol Failure)
  286.      Iab            Information
  287.      ?ccH           Undefined or Unknown frame
  288.  
  289.      Where;
  290.  
  291.      a  = Sequence Number of the next expected frame
  292.      b  = Sequence number of this packet
  293.      cc = Hexadecimal number
  294.  
  295.  
  296. A  final  character  denotes  the   status   of   the   Poll/Final   and
  297. Command/Response bits of the AX.25 protocol;
  298.  
  299.      <none> = Protocol version 1 without P/F Bit
  300.           ! = Poll/Final Bit in Protocol version 1
  301.           ^ = Command Packet in Protocol version 2 (no Poll Bit)
  302.           + = Command Packet in Protocol version 2 (with Poll Bit)
  303.           - = Response Packet in Protocol version 2 (with Final Bit)
  304.           v = Response Packet in Protocol version 2 (no Final Bit)
  305.  
  306.  
  307. The Protocol Identifier (PID) byte is shown in Hexadecimal.
  308.  
  309. Note: The monitor will only function when there are more than  256  free
  310. buffers available in the TNC.
  311.  
  312.  
  313. 6.  More General Terminal Mode Commands
  314.  
  315.  
  316. 6.1.  Connect Text
  317.  
  318. The "<ESC> U" command allows a connect text to be set  and  switched  on
  319. and  off.  This  allows  you  to  set  a small welcoming message perhaps
  320. inviting a caller to leave a message. The connect text message  is  sent
  321. automatically  to any connecting station and in no way affects operation
  322. by the user.
  323.  
  324. When Connect Text is enabled, any incoming text and status messages  for
  325. other  channels are saved in RAM until that channel is selected.  Status
  326. messages and data received can thus be seen in the correct chronological
  327. order.
  328.  
  329. In the event of a channel containing much saved data, remember that  the
  330. "<ESC>  Z"  command  can  be used to select XON/XOFF flow control.  When
  331. enabled, this allows Control-S to stop  the  output  from  the  TNC  and
  332. Control-Q  to  resume  it.  Messages  can  then  be read without loss of
  333. important data.
  334.  
  335.  
  336. 6.2.  The Heard List
  337.  
  338. The internal "Heard" List is activiated by the "<ESC> H"  command.   The
  339. heard  list  implemented  by  The Firmware is somewhat different to that
  340. found in other TNC software in a number of ways.
  341.  
  342. Firstly, it is not a list of the "last 20  stations  heard"  kind.  That
  343. sort  of  list  doesn't  have  much  use  in  today's busy channels. The
  344. Firmware implements a dynamic heardlist. The number of calls  stored  is
  345. determined  by  the free buffer space available in the TNC RAM. With the
  346. standard 32k TNC RAM, it is possible to store upto 600 calls. The growth
  347. of the heard list can be limited by a user definable parameter.
  348.  
  349. For each station heard, the list saves;
  350.  
  351.  
  352.           - Callsign and SSID
  353.           - Date and Time first heard
  354.           - Date and Time last heard
  355.           - Number of I-Frames heard
  356.           - Number of RR-Frames heard
  357.           - Number of REJ-Frames heard
  358.           - Number of RNR-Frames heard
  359.  
  360. The digipeater path is no longer saved since with today's node  network,
  361. this not often of use.
  362.  
  363. The Heard List can provide useful information about the quality  of  the
  364. local channel and of the links between its users. For example, a station
  365. with a high I-frame count and low RR and REJ counts denotes a good  link
  366. quality.
  367.  
  368. There is a small performance overhead  in  maintaining  the  heard  list
  369. which  obviously  increases  with  the size of the list. The list update
  370. mechanism can be switched off with the command "<ESC>  H  0".  The  list
  371. remains in memory whilst switched off but incoming packets are no longer
  372. searched for inclusion in the list.
  373.  
  374.  
  375. 6.3.  The Heard List in Hostmode
  376.  
  377. The H command also works well in Hostmode.  When  requesting  the  heard
  378. list it is important to remember the following points.
  379.  
  380. The first line (H, Number stations heard, maximum  number  in  list)  is
  381. sent  with  Hostmode  Code 1 (Success, Message follows null terminated).
  382. The actual heard list is then sent G/G0 to Channel 0 in Hostmode Code  5
  383. "Monitor Header" format (Monitor Header, null terminated, Info follows).
  384. The last line of the list is sent with Hostmode Code 4 (Monitor  header,
  385. null terminated).
  386.  
  387. The heard list is memory resident, that is,  it  is  saved  following  a
  388. reset or switch off and is held in the battery backed RAM.
  389.  
  390.  
  391. 6.4.  The Real Time Clock
  392.  
  393. Version 2.4c of The Firmware also has  a  built-in  24  hour  clock  and
  394. calendar.  It  is  possible to timestamp all status messages (eg CONNECT
  395. REQUEST from, CONNECTED to etc) aswell as the header of  each  monitored
  396. packet.
  397.  
  398. The "<ESC> K 0" command switches  off  any  timestamping.  "<ESC>  K  1"
  399. switches on timestamping of TNC status messages and "<ESC> K 2" switches
  400. on timestamping of both TNC status messages and monitor headers.
  401.  
  402. The "<ESC> K" command displays the current Date and Time  and  depending
  403. on how the time and date information was entered, it can be displayed in
  404. either American or European format. Date and time are reset to 00/00/00,
  405. 00:00:00  after a cold or "<ESC> QRES" restart.  After a warm start, the
  406. clock continues to run from the previous value stored when the  TNC  was
  407. switched off.
  408.  
  409.  
  410. 7.  Software Improvements
  411.  
  412. This section summarises  the  major  changes  in  this  version  of  the
  413. firmware.
  414.  
  415. 7.1.  AX.25 T1 (Acknowledgement Timer) or FRACK
  416.  
  417. There is no longer a fixed value for the ACK  timer.  The  firmware  now
  418. measures  in  real  time,  the  interval  between  sending  a  frame and
  419. receiving its acknowledgement. This value is then smoothed and  used  to
  420. continuously vary the T1 timer value according to the prevailing channel
  421. conditions.
  422.  
  423. The time measured, or RTT  (Round  Trip  Time)  is  smoothed  from  wide
  424. variations through the formulae;
  425.  
  426.      - with rising RTT:    SRTT' = ( a1 x SRTT + RTT ) / ( a1 + 1 )
  427.  
  428.      - with falling RTT:   SRTT' = ( a2 x SRTT + RTT ) / ( a2 + 1 )
  429.  
  430.  
  431. Therefore, the SRTT (Smoothed Round Trip Time) contains a time  averaged
  432. history  of  previous RTTs. The parameters a1 and a2 are settable by the
  433. user and default to 7 and 15 respectively.
  434.  
  435. The relationship between the AX.25 T1 timer and the SRTT is;
  436.  
  437.        T1 = a3 x SRTT
  438.  
  439.  
  440. where the a3 parameter is user settable (Default = 2)
  441.  
  442. The SRTT must be initialised to a value before the QSO commences, as  at
  443. that  time,  the SRTT cannot be known. This initial value of SRTT can be
  444. set using the "<ESC> F" command which accepts a parameter,  the  initial
  445. SRTT  in 10ms increments (Default = 700). The RTT measurement process is
  446. started after the connection is acknowledged ie after the  UA  frame  is
  447. sent  by  the station to be connected to. When the connect path involves
  448. digipeaters, the RTT is increased due to the expected extra delay by;
  449.  
  450.  
  451.               T1 = (2 x "Number of Digis" + 1) x IRTT
  452.  
  453.  
  454. A1, a2 and a3  can be set with the "<ESC> @A1", "<ESC> @A2"  and  "<ESC>
  455. @A3"  commands.  These  parameters are especially important when using a
  456. FlexNet node which holds back the UA (acknowledgment) frame following  a
  457. connect  request,  until  all nodes along the path have responded to the
  458. request. As soon  as  the  connect  request  is  acknowledged,  the  RTT
  459. measurement is started.
  460.  
  461.  
  462. 7.2.  DWAIT from DL4YBG
  463.  
  464. Before each information frame is sent out, the TNC  will  wait  for  one
  465. Slottime  interval  before  the P-Persistence algorithm is started. This
  466. holds irrespective of whether the TNC is operating in SMACK, normal KISS
  467. or non-DAMA The Firmware modes.
  468.  
  469. When  operating  as  a  DAMA  Slave,  the  persistence  parameters   are
  470. automatically set to Slottime = 0 and Persistence = 255 allowing the TNC
  471. to respond immediately after being asked to send data by the Master.
  472.  
  473. The  chance  of  packet  collisions  is  reduced  by  implementing  this
  474. strategy.
  475.  
  476.  
  477. 7.3.  I-Frame Polling from DK6PX
  478.  
  479. When sending small frames, that are subsequently missed by the receiving
  480. TNC,  it  is sensible to resend the unacknowledged I-frame with the Poll
  481. bit set instead of sending an RR frame.
  482.  
  483. The "<ESC> @I" command can be used to set the threshold packet length at
  484. which  this strategy reverts to normal polling action. "<ESC> @I 0" will
  485. force normal polling to be used at all times, which is also the  default
  486. when the TNC is operating in DAMA mode.
  487.  
  488.  
  489.  
  490. 7.4.  Dynamic MAXFRAME from DK6PX
  491.  
  492. According to packet length, MAXFRAME is  automatically  increased  when,
  493. for example, other pending packets are of small size.
  494.  
  495. With MAXFRAME set to 1, a maximum of one frame with  256  characters  is
  496. sent.  If  there are two frames pending with length 128, MAXFRAME is set
  497. to 2. The default initial value of MAXFRAME is 4.
  498.  
  499.  
  500. 7.5.  DCD/PTT Lock-up
  501.  
  502. A previous bug in one of the software interrupt  routines,  could  under
  503. certain  circumstances  cause  TNC  lock-up.  This  bug  existed  in all
  504. previous versions of The Firmware  and  was  solved  by  Y51GE.  Another
  505. related bug which caused DCD lockup was also fixed.
  506.  
  507.  
  508. 7.6.  DAMA Parameters
  509.  
  510. When DAMA mode is deactivated, the  parameters  P,  W,  B  and  @T2  are
  511. automatically reset to their user defined values.
  512.  
  513.  
  514. 7.7.  Disconnect from DL1MEN
  515.  
  516. If a pending connect request is aborted with the "<ESC>  D"  command,  a
  517. DISC (Disconnect) frame is automatically sent. This prevents the station
  518. that was to have been  connected  with,  from  sending  any  unnecessary
  519. frames following the connect abort.
  520.  
  521.  
  522. 7.8.  Heard List
  523.  
  524. The heard list now shows the last heard station rather  than  the  first
  525. heard station. If the heard list is full, the oldest call is removed.
  526.  
  527.  
  528. 8.  The Firmware Command List
  529.  
  530.  
  531. 8.1.  ESC A [0|1]
  532.  
  533. Send Linefeed (<LF>) character to terminal after  each  Carriage  Return
  534. (<CR>). (1 = Yes, 0 = No, Default = Yes)
  535.  
  536.  
  537. 8.2.  ESC B [<n>]
  538.  
  539. Time interval in seconds after which DAMA mode is  deactivated  when  no
  540. Poll frame from the DAMA Master is received.
  541.  
  542. "<ESC> B 0" = Switch off DAMA mode completely
  543.  
  544. "<ESC> B" displays "Interval (Actual Value)" eg "120 (93)"
  545.  
  546. Default = 120 seconds.
  547.  
  548.  
  549. 8.3.  ESC C [Call] [Digi List]
  550.  
  551. Make a connect to the given call. Note that the keyword "v" or "via"  is
  552. *not* required between the Call and the Digi List.
  553.  
  554. "<ESC> C [Call]" on Channel 0 sets the callsign (and optional  path)  to
  555. be used for UI-frames. For example set;
  556.  
  557.           ESC C ID
  558.      or
  559.           ESC C CQ
  560.  
  561.  
  562.  
  563. 8.4.  ESC D
  564.  
  565. Disconnect the currently selected channel.
  566.  
  567. If there is still data to send or  to  be  acknowledged,  the  QSO  will
  568. continue until so done. If this is not what is required, a second "<ESC>
  569. D" command can be given to abort the connection.
  570.  
  571. If the currently selected channel is already in the disconnected  state,
  572. all channel settable parameters are reloaded with their defaults held in
  573. Channel 0.
  574.  
  575.  
  576. 8.5.  ESC E [0|1]
  577.  
  578. Echo all characters sent to the TNC.
  579.  
  580. 1 = Yes, 0 = No, Default= Yes.
  581.  
  582.  
  583. 8.6.  ESC F [<n>]
  584.  
  585. Set initial the FRACK value which determines how long  to  wait  for  an
  586. acknowledgement  after an I-frame is sent. This interval can be input in
  587. seconds. If the parameter input is less than 16, the value is multiplied
  588. by  100  and  divided by the A3 parameter (input via "<ESC> @A3"). Input
  589. parameters greater than 15 are taken as milliseconds  (ie  the  Level  2
  590. Round Trip Time).
  591.  
  592. Default = 250
  593.  
  594.  
  595. 8.7.  ESC G [0|1]
  596.  
  597. This is a hostmode only command and is used to inquire as to the  status
  598. of the current channel.
  599.  
  600. If entered in Terminal mode, an error message will be given.
  601.  
  602.  
  603. 8.8.  ESC H [<n>]
  604.  
  605. Display the heard list and set the heard list parameters.
  606.  
  607. Examples;
  608.  
  609.  
  610.      H        -  Display Heardlist
  611.      H 0      -  Heardlist Update Off
  612.      H 1      -  Heardlist Update On
  613.      H 2      -  Clear Heardlist
  614.      H n      -  Maximum Number of calls in list (n > 2)
  615.  
  616.  
  617. The list is shown in order of the last callsign  heard  and  the  oldest
  618. heard callsign will be overwritten when the list becomes full.
  619.  
  620. The heard list is resident. It remains saved in the battery backed RAM.
  621.  
  622. Default = 0 (Heardlist off)
  623.  
  624.  
  625. 8.9.  ESC I [Call]
  626.  
  627. Set MYCALL for the TNC. After a cold-start, the call is unset.
  628.  
  629. The callsign can be set independently on  each  channel  and  when  that
  630. channel  is disconnected, the call set in Channel 0 is again assumed for
  631. that channel.
  632.  
  633. Note that the TNC will only transmit *after* the call has been set using
  634. this command.
  635.  
  636.  
  637. 8.10.  ESC JHOST[0|1]
  638.  
  639. This command is used to toggle between Hostmode and Terminal Mode.  Host
  640. mode  is  not  a "human" interface and is designed for computer control.
  641. Packet terminal programs such as GIPSY, THP, AHP, SP (Super Packet)  and
  642. Packet Master use this Host mode interface.
  643.  
  644.  
  645. 8.11.  ESC K [<n>]
  646.  
  647. Activate timestamping of status messages and monitor headers. The  built
  648. in real-time clock/calendar is used.
  649.  
  650. Examples:
  651.  
  652.  
  653.      K            -  Display current Date and Time
  654.      K 0          -  Timestamping OFF
  655.      K 1          -  Status Message Timestamping ON
  656.      K 2          -  Status Message and Monitor Timestamping ON
  657.      K 20.02.88   -  Set Date - European format
  658.      K 02/20/88   -  Set Date - American format
  659.      K 17:36:00   -  Set Clock time
  660.  
  661.  
  662. Default = 0 (All timestamping OFF)
  663.  
  664.  
  665. 8.12.  ESC L [0..10]
  666.  
  667. This command is used to display the status of logical TNC channels.   If
  668. given without parameters, the status of all channels will be displayed.
  669.  
  670. Information such as connect path, frames received, frames  to  be  sent,
  671. frames to be acknowledged and retry counter value are displayed.
  672.  
  673. The currently selected (ie default) channel  is  displayed  with  a  "+"
  674. mark.
  675.  
  676.  
  677. 8.13.  ESC M [IUSCN+-]
  678.  
  679. This command is used to select the monitor mode. The parameters  to  the
  680. command  determine the types of frames displayed by the monitor and also
  681. which stations are selected or filtered from the display.
  682.  
  683. Examples:
  684.  
  685.  
  686.      N        None (Monitor OFF)
  687.      I        Show only Information Frames
  688.      U        Show only UI frames (CQ, BEACON etc)
  689.      S        Show Supervisory frames
  690.      C        Monitor whilst connected
  691.      +        Followed by list of upto 8 calls
  692.               which will be the only ones shown.
  693.      -        Followed by list of upto 8 calls
  694.               which will be ignored.
  695.  
  696.  
  697. The "I", "U", "S" and  "C"  parameters  may  be  combined  in  a  single
  698. command.  For  example,  "<ESC>  M IUSC" will display all possible frame
  699. types and the monitor will be active when a channel is in the  connected
  700. state.
  701.  
  702. The "+" and "-" parameters may *not* be combined in  a  single  command.
  703. The  command  with  just a "+" or "-" parameter will clear the lists and
  704. return to normal operation.
  705.  
  706. Default = UI  (Monitor displays UI and Information frames)
  707.  
  708.  
  709. 8.14.  ESC N [0..127]
  710.  
  711. Set the maximum number of retries for each  Information  frame  sent.  A
  712. value of 0 instructs the TNC to retry forever.
  713.  
  714. The retry counter can be set independently on each  channel.  When  that
  715. channel  is  disconnected  or  a RESET command is given, the retry value
  716. stored in Channel 0 becomes the default.
  717.  
  718. Default = 10 (Tries)
  719.  
  720.  
  721. 8.15.  ESC O [1..7]
  722.  
  723. Set the maximum number of information frames that may be outstanding and
  724. unacknowledged at any one time (MAXFRAME).
  725.  
  726. The MAXFRAME can be set independently on each channel. When that channel
  727. is disconnected or a RESET command is given, the value stored in Channel
  728. 0 becomes the default.
  729.  
  730. Default = 2 (Frames unacknowledged)
  731.  
  732.  
  733. 8.16.  ESC P [0..255]
  734.  
  735. Set the TNC's Persistence value for determining channel access priority.
  736. DAMA Slaves always set P = 255.
  737.  
  738. Default = 32 (32/255 chance of access)
  739.  
  740.  
  741. 8.17.  ESC QRES
  742.  
  743. Cold start The Firmware and reload the EPROM defaults.
  744.  
  745.  
  746. 8.18.  ESC R [0|1]
  747.  
  748. Enable the TNC digipeat function. 1 = Yes, 2 = No.
  749.  
  750. Default = 1 (Allow TNC to digipeat)
  751.  
  752.  
  753. 8.19.  ESC S [0..10]
  754.  
  755. Select the given logical channel. 0 is the Monitor channel.
  756.  
  757. Default = 0 (Default channel is the monitor channel).
  758.  
  759.  
  760. 8.20.  ESC T [0..127]
  761.  
  762. Set the  delay  between  keying  the  transmitter  and  sending  a  data
  763. (TXDELAY).  The  value given is in 10ms increments. For example, a delay
  764. of 300ms would be "<ESC> T 30". The value should be experimented with to
  765. suit your TX, but set it as low as possible.
  766.  
  767. Default = 25 (250ms)
  768.  
  769.  
  770. 8.21.  ESC U [0|1]
  771.  
  772. Set (or display) the Connect Text for the TNC. The text is saved even if
  773. the function is switched off.
  774.  
  775. Examples:
  776.  
  777.  
  778.      U 1 "Hello!"      Enter Connect Text
  779.      U 1               Enable Connect Text
  780.      U 0               Disable Connect Text
  781.      U                 Display Connect Text
  782.  
  783.  
  784. Default = 0 (No Connect Text, Disable Connect Text).
  785.  
  786. 8.22.  ESC V
  787.  
  788. Display the current AX.25 Protocol Version in use. Protocol version 1 is
  789. no longer supported by The Firmware from v2.4 onwards.
  790.  
  791.  
  792. 8.23.  ESC W [0..127]
  793.  
  794. Set (or display) the TNC Slot Time to be  used  in  determining  channel
  795. access priority. The value given is in milliseconds.
  796.  
  797. Default = 10 (ms)
  798.  
  799.  
  800. 8.24.  ESC X [0|1]
  801.  
  802. Disable the transmitter PTT line.
  803.  
  804. Default = 1 (PTT enabled)
  805.  
  806.  
  807. 8.25.  ESC Y [0..10]
  808.  
  809. Set (or display) the maximum number of simultaneous connects allowed  to
  810. or  from  the TNC. If given without parameters, the command will display
  811. "Max No. Connects (Occupied Channels)". This is only the case  when  all
  812. channels have the same SSID set as that on Channel 0.
  813.  
  814. Example: "4 (1)"
  815.  
  816. Default = 4 (A maximum of 4 channels in use at any one time).
  817.  
  818.  
  819. 8.26.  ESC Z [0..3]
  820.  
  821. Determine TNC flow control and XON/XOFF handshaking.
  822.  
  823. If flow control is enabled, the TNC will not send data to  the  terminal
  824. if  a  command or data to be sent is being entered. When flow control is
  825. disabled, the TNC  will  immediately  send  any  data  to  the  terminal
  826. regardless of whether a command or data is being entered.
  827.  
  828. If XON/XOFF handshaking is enabled, the user may stop  TNC  output  with
  829. the Control-S key and restart it with Control-Q.
  830.  
  831. Examples:
  832.  
  833.  
  834.      0      Flow  On     , XON/XOFF  Off
  835.      1      Flow  Off    , XON/XOFF  Off
  836.      2      Flow  On     , XON/XOFF  On
  837.      3      Flow  Off    , XON/XOFF  On
  838.  
  839.  
  840. Default = 3 (Flow control off, XON/XOFF on)
  841.  
  842.  
  843. 9.  Extended TNC Commands
  844.  
  845. There are a number of extended TNC commands that are prefixed  with  the
  846. "@" character eg "<ESC> @A1".
  847.  
  848.  
  849. 9.1.  ESC @A1 [<n>]
  850.  
  851. Set or display the a1 SRTT calculation parameter. Default = 7.
  852.  
  853.  
  854. 9.2.  ESC @A2 [<n>]
  855.  
  856. Set or display the a2 SRTT calculation parameter.  Default = 15.
  857.  
  858.  
  859. 9.3.  ESC @A3 [<n>]
  860.  
  861. Set or display the a3 SRTT calculation parameter.  Default = 3.
  862.  
  863.  
  864. 9.4.  ESC @B
  865.  
  866. Display the free buffer count in the software.
  867.  
  868.  
  869. 9.5.  ESC @D [0|1]
  870.  
  871. Enable Full-duplex mode. Default = 0 (simplex)
  872.  
  873.  
  874. 9.6.  ESC @I [<n>]
  875.  
  876. Set (or display) the I-poll threshold. The value given is the number  of
  877. bytes  at  which  if packets longer than that are waiting to be sent, I-
  878. poll will not be used.
  879.  
  880. Default = 60 (bytes)
  881.  
  882.  
  883. 9.7.  ESC @K
  884.  
  885. Start KISS/SMACK mode.
  886.  
  887.  
  888. 9.8.  ESC @M [0|1]
  889.  
  890. Set 7 or 8 bit (binary) terminal mode.
  891.  
  892. When in 7 bit mode, control characters are automatically displayed  with
  893. a  leading  "^"  prefix. In 8 bit or binary mode, control characters are
  894. passed through without translation.
  895.  
  896. Note that XON/XOFF should not be used at the Terminal end as it may hang
  897. when seeing the XOFF ("^S") character.
  898.  
  899. The default is to operate in binary mode (@M  =  1)  and  the  character
  900. translation  does not occur. The command is however important when using
  901. Hostmode software eg THP, SP etc.
  902.  
  903. 0 = 7-Bit; 1 = 8-Bit (only in Terminal-Mode)
  904.  
  905. Default = 1 (binary, 8 bit mode)
  906.  
  907.  
  908. 9.9.  ESC @T2 [<n>]
  909.  
  910. Time interval to delay acknowledgement of received frames.
  911.  
  912. Default = 150 (1.5 seconds)
  913.  
  914.  
  915. 9.10.  ESC @T3 [<n>]
  916.  
  917. Set or display the link  "keep  alive"  timer.  If  the  link  has  been
  918. inactive for @T3 seconds, the link partner is polled for activity.
  919.  
  920. Default = 18000 (ms)
  921.  
  922.  
  923. 9.11.  ESC @V [0|1]
  924.  
  925. Enable  callsign  checking,  eg  rejection  of  connect  requests   from
  926. "NOCALL". (1 = Enabled, 0 = Disabled).
  927.  
  928. Default = 0 (disabled)
  929.  
  930.  
  931. 10.  Acknowledgements
  932.  
  933. Original documentation in German by DB2OS, DF2AU und DC4OX.
  934.  
  935. Updated by DJ1OR September 1992.
  936.  
  937. English translation by Mike Chace (G6DHU) February 1993.
  938.  
  939. --- End of message #49728  from DB2OS  to TNC2   @WW     ---
  940.  
  941.